home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr24 / dup21.zip / F2H21.DOC < prev    next >
Text File  |  1993-04-08  |  14KB  |  482 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.                       F 2 H
  21.  
  22.  
  23.  
  24.                    Version 2.1
  25.  
  26.  
  27.  
  28.                   Documentation
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.       F2H   Copyright 1992, 1993   Chang Ping Lee   ALL RIGHTS RESERVED
  56.  
  57.  
  58.  
  59.       F2H   Copyright 1992, 1993   Chang Ping Lee                   page  1
  60.  
  61.  
  62.  
  63.                   Table Of Contents
  64.  
  65.  
  66.       Disclaimer of warranty. . . . . . . . . . . . . . . . . . . .  2
  67.  
  68.       License . . . . . . . . . . . . . . . . . . . . . . . . . . .  3
  69.  
  70.       1.   Introduction . . . . . . . . . . . . . . . . . . . . . .  4
  71.  
  72.       2.   How to install and run F2H . . . . . . . . . . . . . . .  5
  73.  
  74.       3.   Configuration file and command line arguments. . . . . .  6
  75.  
  76.       4.   Inside CONFIG.DCF. . . . . . . . . . . . . . . . . . . .  7
  77.  
  78.       5.   Command line arguments and examples. . . . . . . . . . .  8
  79.  
  80.       6.   What will be copied, what will not . . . . . . . . . . . 10
  81.  
  82.       7.   Benchmark. . . . . . . . . . . . . . . . . . . . . . . . 11
  83.  
  84.  
  85.  
  86.       F2H   Copyright 1992, 1993   Chang Ping Lee                   page  2
  87.  
  88.  
  89.  
  90.             DISCLAIMER  OF WARRANTY
  91.  
  92.  
  93.     THIS SOFTWARE AND MANUAL ARE SUPPLIED "AS IS." THE AUTHOR HEREBY
  94.     DISCLAIMS ALL WARRANTIES RELATING TO THIS SOFTWARE AND ITS
  95.     DOCUMENTATION FILE, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED
  96.     TO DAMAGE TO HARDWARE, SOFTWARE AND/OR DATA FROM USE OF THIS
  97.     PRODUCT. IN NO EVENT WILL THE AUTHOR OF THIS SOFTWARE BE LIABLE
  98.     TO YOU OR ANY OTHER PARTY FOR ANY DAMAGES. YOUR USE OF THIS
  99.     SOFTWARE INDICATES THAT YOU HAVE READ AND AGREE TO THESE AND
  100.     OTHER TERMS INCLUDED IN THIS DOCUMENTATION FILE.
  101.  
  102.  
  103.     DUE TO THE NATURE OF EVOLVING PROGRAMMING AND THE VARIOUS
  104.     HARDWARE AND SOFTWARE ENVIRONMENTS IN WHICH THIS SOFTWARE MAY
  105.     BE USED, IT IS UNDERSTOOD THAT OCCASIONAL "BUGS" OR UNFITNESS
  106.     MAY ARISE. THE USER SHOULD ALWAYS TEST THIS SOFTWARE THOROUGHLY
  107.     WITH NON-CRITICAL DATA BEFORE RELYING ON IT.
  108.  
  109.  
  110.  
  111.       F2H   Copyright 1992, 1993   Chang Ping Lee                   page  3
  112.  
  113.  
  114.  
  115.                 LICENSE
  116.  
  117.  
  118.     1. In return for the payment of a one time fee, the customer is
  119.     granted a non-commercial or commercial license.
  120.  
  121.     2. If the registration is for a non-commercial license the customer
  122.     can use the software for personal backup or other usages in which
  123.     the customer make no profit and the duplicated diskettes of any
  124.     particular source diskette (or image file) are not distributed to
  125.     more than ten persons. In addition, the software may not be used in
  126.     any business, organization, institution or government agency.
  127.  
  128.     3. If the registration is for a commercial license the customer can
  129.     use the software in a business, organization, institution or
  130.     government agency, for profit or non-profit purposes. With a
  131.     commercial license the customer can distributed the duplicated
  132.     diskettes to as many persons as he or she likes
  133.  
  134.     4. The customer may use the product just-like-a-book which means
  135.     this software can be used by more than one person and can be moved
  136.     from one computer to another so long as there is NO POSSIBILITY of
  137.     it being used by two different persons on two different computers
  138.     at the same time, just like a book can not be read by two different
  139.     persons in two different places at the same time.
  140.  
  141.     5. This software and its documentation and all supplemental files
  142.     are property of the author and may not be duplicated for sale to
  143.     any third parties without written permission from the author.
  144.  
  145.     6. The customer agrees that this product is protected by United
  146.     States copyright law and international copyright treaty provisions.
  147.     Purchase of this license does not transfer any right, title or
  148.     interest in the product to the customer except as specifically set
  149.     forth in this license agreement.
  150.  
  151.     7. The author of this software product reserves the right to
  152.     terminate this license upon breach.
  153.  
  154.  
  155.  
  156.       F2H   Copyright 1992, 1993   Chang Ping Lee                   page  4
  157.  
  158.  
  159.  
  160.     1. INTRODUCTION:
  161.  
  162.  
  163.        F2H (Floppy to Hard disk) is a utility to copy a diskette to
  164.        hard disk at very high speed. The whole structure on a diskette
  165.        including sub directories and files will be copied to the
  166.        current directory on a hard disk or RAM disk.
  167.  
  168.  
  169.        For performance information see page 11 of this documentation.
  170.  
  171.  
  172.  
  173.       F2H   Copyright 1992, 1993   Chang Ping Lee                   page  5
  174.  
  175.  
  176.  
  177.     2. HOW TO INSTALL AND RUN F2H
  178.  
  179.  
  180.        Copy the EXE and DOC files to a directory created for DCF and
  181.        DUP. Define the PATH in your AUTOEXEC.BAT to include this
  182.        directory or the directory of a one-line batch file which
  183.        contains the path of F2H.EXE.
  184.  
  185.  
  186.        Attach to the target directory then type "F2H" followed by the
  187.        "enter" key to copy from a floppy drive to the target directory.
  188.        You can specify the source floppy drive on the command line.
  189.  
  190.  
  191.        If you only have one or two floppy drives you can skip the rest
  192.        of this section.
  193.  
  194.  
  195.        In systems with four floppy drives, if a device driver which
  196.        came with the controller is installed F2H usually can detect the
  197.        drive letters automatically and the drive letters should be used
  198.        to specify the third and fourth drives. If no device driver
  199.        (TSR) is installed you need to use 3 and 4 as the drive letters
  200.        for the third and fourth drives. In this case you need to edit a
  201.        text file, CONFIG.DCF, that provides the information on floppy
  202.        drive capacity.
  203.  
  204.  
  205.        The following is an example of the text file in which a 1.2MB,
  206.        a 1.44MB and a 360KB drives are specified as the first, the
  207.        second and the third drives with drive letters A: B: and G:,
  208.        respectively. The 0 on the last line indicates that the fourth
  209.        drive is not installed. If all drives are defined, such as in
  210.        the example, F2H will not check with DOS for drive capacity.
  211.        This can speed up the initialization process.
  212.  
  213.        $DRIVE
  214.         1 1200 A:
  215.         2 1440 B:
  216.         3  360 G:
  217.         4    0
  218.  
  219.  
  220.  
  221.       F2H   Copyright 1992, 1993   Chang Ping Lee                   page  6
  222.  
  223.  
  224.  
  225.     3. CONFIGURATION FILE AND COMMAND LINE ARGUMENTS
  226.  
  227.  
  228.        If you have read the DOC file of DCF you can skip this section
  229.        and continue at section 6.
  230.  
  231.  
  232.        Basically, configuration file is used to stored information
  233.        which you don't expect to change often while command line
  234.        arguments are used for specifying more dynamic parameters.
  235.  
  236.  
  237.        For example, it's unlikely that you need to change the drive
  238.        capacity often, so these information can only be specified in
  239.        the configuration file, not on the command line.
  240.  
  241.  
  242.        On the other hand, it's unlikely that you use the same source
  243.        and target each time, so these can only be specified on the
  244.        command line, not in the configuration file.
  245.  
  246.  
  247.        The only information you can specified both in the configuration
  248.        file and command line is the default options. You may have your
  249.        own idea how the defaults should be (in configuration file) and
  250.        make a slight adjustment (on command line) when necessary. In
  251.        other words, command line options override the configuration
  252.        file options.
  253.  
  254.  
  255.        The configuration file is a text file. The default file name is
  256.        CONFIG.DCF. If you use the default file name you can simply type
  257.        "F2H" at DOS prompt and the program will retrieve information
  258.        from the file automatically.
  259.  
  260.  
  261.        There are cases that you need to use a different name. For
  262.        example, you may want to keep two configuration files for
  263.        different applications. In this case you need to provide the
  264.        file name on the command line. For example, if file ABC is your
  265.        configuration file you need to type "F2H @ABC" at DOS prompt.
  266.  
  267.  
  268.        The usage of the configuration file is explained in the next
  269.        section. The usage of command line arguments is fully explained
  270.        in section 5.
  271.  
  272.  
  273.  
  274.       F2H   Copyright 1992, 1993   Chang Ping Lee                   page  7
  275.  
  276.  
  277.  
  278.     4. INSIDE CONFIG.DCF
  279.  
  280.  
  281.        If you have read the DOC file of DCF you can skip this section
  282.        and continue at section 6.
  283.  
  284.  
  285.        The user can specify up to seven keywords in the configuration
  286.        file. Each keyword specify a specific kind of parameters or
  287.        information.
  288.  
  289.  
  290.        $DRIVE : You don't need to provide this information except for
  291.             the following two cases. If the program fails to get
  292.             the correct drive capacity from your system or if you
  293.             want to access four drives without installing the
  294.             device driver which came with the controller you can
  295.             use this keyword to specify the drive capacity in the
  296.             CONFIG.DCF file.
  297.  
  298.             The next few lines contain parameters about diskette
  299.             drives in your system. On each line, the first number
  300.             specify the drive, 1 for drive A:, 2 for drive B:, 3
  301.             and 4 for third and fourth drives in a four drive
  302.             system. The second number is the drive capacity in KB.
  303.             A drive letter (optional) can be specified at the end.
  304.             See section 4 of DCF40F.DOC for details.
  305.  
  306.  
  307.        $OPTION : The next few lines specify the default options used by
  308.              F2H at start up. The format is the same as those on
  309.              the command line but without the leading /. See
  310.              section 5 for details.
  311.  
  312.  
  313.        $SYSPATH : The next line specifies the path for system file.
  314.               For example, sound files are considered system files.
  315.  
  316.  
  317.        $IMGPATH : Not used by F2H.
  318.  
  319.  
  320.        $TMPPATH : The next line specifies the alternative path for the
  321.               program to create temporary files. If you have a RAM
  322.               disk, you can specify the path to be on your RAM
  323.               disk. Not only speed will be faster but also you save
  324.               your hard disk from unnecessary burden.
  325.  
  326.  
  327.        $NOMSG : Not used by F2H.
  328.  
  329.  
  330.  
  331.       F2H   Copyright 1992, 1993   Chang Ping Lee                   page  8
  332.  
  333.  
  334.  
  335.     5. COMMAND LINE ARGUMENTS AND EXAMPLES
  336.  
  337.  
  338.        If you have read the DOC file of DCF you can skip this section
  339.        and continue at section 6.
  340.  
  341.  
  342.        There are fourteen options you can specify using command line
  343.        arguments. You can also specify these options in the CONFIG.DCF
  344.        file. The command line options override the CONFIG.DCF options.
  345.  
  346.  
  347.        In addition, you can also specify an alternative configuration
  348.        file on the command line. See examples at the end of this
  349.        section.
  350.  
  351.  
  352.        Note that the '+' sign after any option can be omitted.
  353.  
  354.  
  355.        /c  Not used by F2H.
  356.  
  357.        /m  Not used by F2H.
  358.  
  359.        /f  followed by +/-. Set Fast ON/OFF. When ON the program will
  360.            only read the portion with active data and skip empty
  361.            portion of diskettes.  Default is ON.
  362.  
  363.        /s  followed by +/-. Set Sound ON/OFF. When ON the program will
  364.            give an audio signal after writing a diskette or 20 seconds
  365.            of inactivity. Default is ON.
  366.  
  367.        /q  Not used by F2H.
  368.  
  369.        /k  Not used by F2H.
  370.  
  371.        /n  Not used by F2H.
  372.  
  373.        /d  followed by +/-. Set Delay ON/Off. If your machine is not so
  374.            slow as an 8088/4.77MHz and would like to see whether the
  375.            program can copy at highest speed on your system try /d-.
  376.            Default is ON.
  377.  
  378.  
  379.  
  380.       F2H   Copyright 1992, 1993   Chang Ping Lee                   page  9
  381.  
  382.  
  383.  
  384.  
  385.  
  386.  
  387.        /t  followed by +/-. Set density priority. If + the program tries
  388.            reading a new disk as a high density disk in a 1.2 or 1.44MB
  389.            drive. If - low density has higher priority. Default is +.
  390.  
  391.        /o  followed by +/-. Set "mono in color" mode. In a color
  392.            system, you can use /o+ to force F2H run in black and white.
  393.            Default is -.
  394.  
  395.        /x  Not used by F2H.
  396.  
  397.        /b  Not used by F2H.
  398.  
  399.        /a  Not used by F2H.
  400.  
  401.        /w  followed by +/-. Set "write protect" ON/OFF. If ON the
  402.            program will not read a diskette which is not write-
  403.            protected. This is useful when the source diskettes are all
  404.            write-protected. Default is OFF.
  405.  
  406.        @file_name  specify alternative name for the configuration file.
  407.  
  408.        drive:  define a floppy drive as source drive.
  409.  
  410.  
  411.        EXAMPLES:
  412.  
  413.  
  414.        F2H /w+d-s-    Set defaults of Write-protect, Delay and Sound to
  415.               to ON, OFF and OFF.
  416.  
  417.        F2H /wd-s-     Same as the last example. The '+' can be and is
  418.               omitted.
  419.  
  420.        F2H A:         Copy drive A: to current directory.
  421.  
  422.        F2H 3:         Copy from the third drive, when device driver is
  423.               not installed.
  424.  
  425.        F2H G:         Same as the last example, but in this case the
  426.               driver is installed and the drive letters is G.
  427.  
  428.  
  429.  
  430.       F2H   Copyright 1992, 1993   Chang Ping Lee                   page 10
  431.  
  432.  
  433.  
  434.     6. WHAT WILL BE COPIED, WHAT WILL NOT
  435.  
  436.  
  437.        All the files and sub directories and their structure are copied
  438.        to the current directory, usually on a hard disk or RAM disk. If
  439.        a sub directory does not exist on hard disk one will be created.
  440.        If a file already exists, user will be prompted for permission
  441.        to overwrite. The names, times, dates and attributes of all the
  442.        files are preserved.
  443.  
  444.        The directories will have different times, dates and attributes,
  445.        however. The diskette label, serial number and other information
  446.        contained in the system area will not be copied.
  447.  
  448.  
  449.  
  450.       F2H   Copyright 1992, 1993   Chang Ping Lee                   page 11
  451.  
  452.  
  453.  
  454.     7. BENCHMARK
  455.  
  456.  
  457.                   H2F vs XCOPY      F2H vs XCOPY
  458.        --------------------------------------------------
  459.         Case 1 (1.2 MB)    8  vs  40         8  vs  17
  460.         Case 1 (1.44MB)    9  vs  50         9  vs  19
  461.         Case 2 (1.2 MB)    9  vs  33         9  vs  18
  462.         Case 2 (1.44MB)    8  vs  40         9  vs  19
  463.         Case 3 (360 KB)   18  vs 135        19  vs  27
  464.         Case 3 (1.2 MB)   11  vs  93        12  vs  19
  465.         Case 3 (1.44MB)   11  vs 106        12  vs  18
  466.  
  467.  
  468.         Note: (1) Case 1 contains 36 files and no sub directory.
  469.               Case 2 contains 13 files in 21 sub directories.
  470.               Case 3 contains 80 files in 28 sub directories.
  471.               Total file size is about 300 KB in all cases.
  472.  
  473.  
  474.           (2) Performance varies on different system. The
  475.               above benchmark result is provided as examples,
  476.               NOT guarantee.
  477.  
  478.  
  479.           (3) The above results were measured with a RAM disk
  480.               on a 33 MHz 386 compatible system.
  481.  
  482.